package com.huiying.service;

/**
 * 文件URL服务接口
 * 定义了将本地存储文件名转换为可访问URL的功能
 */
public interface FileUrlService {

    /**
     * 根据本地存储的文件名，生成一个完整可访问的 URL。
     * 该URL可以被前端浏览器直接用于显示图片、下载文件等。
     *
     * @param storedFileName 数据库中存储的文件名 (e.g., "8d6a5e92-8e97-41d2-9fd5-ea8b5385d694.png")
     * @return 完整的文件 URL (e.g., "http://localhost:8080/files/8d6a5e92-8e97-41d2-9fd5-ea8b5385d694.png")
     * 如果文件名为空或null，则返回null (可根据需求修改为返回默认占位符URL)
     */
    String generateFileAccessUrl(String storedFileName);
}